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Section 1 
Introduction 



1. 1 GENERAL INFORMATION 

Be sure to copy this master. For copy procedures* refer to the 
DXIQ Operations Guide * TI part number 946250-9702. 

Many of the system command interpreter (SCI) commands in this 
document are given in abbreviated form. These can be executed by 
entering the command exactly as it is shoun. Alternatively* you 
can issue the commands without parameters and respond to the SCI 
prompts for any required parameter values. For more discussion 
of the two command forms* refer to the DXIO Operations Guide * TI 
part number 946250-9702. 



1.2 MEDIA DEFINITION 

Product shipments are made in three formats: 

* Disk — The object is shipped on a CD1400* DS80* or 
DS300 disk pack* or on a double-sided* double-density 
(DSDD) diskette. 

* Magnetic Tape — The object is shipped on a 1600 bit- 
per-inch magnetic tape reel or magnetic tape cartridge. 

* Add -On — The object and one or more additional products 
are shipped on a CDi400* DS80* or DS300 disk pack. 

The installation instructions in this document assun^e that the 
object files are accessible by synonyms. Section 2 describes houi 
to prepare the media so that the files can be accessed by 
synonyms. 
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1.3 THE INSTALLATION PROCEDURE 

The object medium contains the files and batch streams to perform 
the following: 

* Install the object files 

* Verify the installation 



1.4 SYSTEM REQUIREMENTS 

To perform this installation procedure successfully you must have 
a DXIO system^ Version 3. 4 or later. 
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Section 2 
Preparing for Installation 



2. 1 INTRODUCTION 

Before executing the installation instructions* you must prepare 
the object files so that the batch stream can access them. The 
following paragraphs describe! for each of the available storage 
media* how to prepare the files. 



2. 2 DISK FORMAT 

If you received the object on a disk* prepare it for installation 
by performing the following steps: 

1. Put the installation disk in an available disk drive on 
a functioning DXiO system (Version 3.4 or later) and 
load it. 

2. Install the disk by issuing the following command: 

C 3 IV U=DSxx* V=CBLINS10 

where: 

DSxx is the disk drive on which you have loaded the 
disk. 

Proceed to Section 3 for instructions on installing the object. 
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2. 3 MAGNETIC TAPE FORMAT 

If you received the object on magnetic tape# you must move the 
files to a disk before beginning the installation process^ as 
explained in the following steps: 

i. Create a directory on a disk by issuing the following 
command: 

C 1 CFDIR P=<volume name>. CBLINSIO, M=25 

where: 

<volume name> is the name of the disk on which you wish to 
create the directory. 

2. Load the magnetic tape reel or cartridge. 

3. Move the contents of the magnetic tape to the directory 
you created by issuing the following command: 

C 3 RD S«MTxx, D«<volume name>. CBLINSIO, L=. LISTING 

where: 

MTxx is the tape drive from which the object is 
to be copied. 

<volume name> is the name of the disk volume 
to which the object is to be copied. 

A listing of the directory restored from the magnetic 
tape will be written to the file .LISTING. You can 
examine this file by executing a Show File <SF) or a 
Print File iPF) command. 

4. Unload the magnetic tape reel or cartridge. 

Proceed to Section 3 for instructions on installing the object. 
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2. 4 ADD-ON FORMAT 

If you received the object as an add-on package^ prepare it for 
installation by performing the following steps: 

1. Put the disk containing the add-on package in an 
available disk drive on a functioning DXIO system 
(Version 3.4 or later) and load it. 

2. Install the disk by issuing the following command: 

C 3 IV U=DSxXf V=<volume name> 

where: 

DSxx is the disk drive on which you have loaded the 
volume. 

<volume name> is the volume name of the add— on disk 
The volume name is marked on the disk. 

You can also execute a Show Volume Status (SVS) command 
to obtain the volume name. 
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Section 3 
Installing the Object 



3. 1 INTRODUCTION 

This section describes the p^rocedure for installing the COBOL 
compiler and run-time support package on your DXIO system. The 
installation process accomplishes the follouiing: 

1. Deletes any previously installed version of DXIO COBOL 

2. Installs the DXIO COBOL run-time routines and compiler 



3. 2 INSTALLATION PROCEDURES 

To install the COBOL compiler and run— time support package^ 
perform the following steps: 

1. Designate the installation disk as an alternate 
procedure library uiith the following command: 

C 3 .USE <volume name># . S*PROC 

where: 

<volume name> is either the name of the installation 
disk or the name of the disk file to which the object 
was copied. 



2. Execute the SCI command INSTALL. The following prompts 
will appear: 

I 1 INSTALL 

NAME of Installation Disk: CBLINSIO 

INSTALL on System Disk: YES 

TARGET Volume name/Device: DSOl 

LIBRARY Volume name/Device: DSOl 

SYSTEM Program File Name: . S*PROGA 
BATCH EXECUTION Listing File: 
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The TARGET Volume name/Device prompt identifies the 
installation destination for the compiler and the run- 
time support package. This will normally be on the 
standard system disk DSOlf which is the default value. 

The LIBRARY Volume name/Device prompt is for the 
location of the . S$SYSLIB files. These are the piece 
parts used when linking a run-time procedure with a 
program. The default for this prompt is the standard 
system disk DSOl. 

The SYSTEM Program File Name prompt is for the name of 
the system program file on the target disk. If this 
name is not the default value ". S*PROGAi " the correct 
name must be entered. 

You can find this name by issuing the Modify Volume 
Information (MVI) command as follows: 



Z 1 MVI 



MODIFY VOLUME INFORMATION 
CONTROL ACCESS NAME: ME 
DISK?: <volume number> 
COMMAND(L, C, S# Q>?: L 



The following prompts should appear: 

PRIMARY SECONDARY SELECT 



SYSTEM IMAGE 

PROGRAM FILE 

OVERLAY FILE 

LOADER FILE 

WCS FILE 

DIAGNOSTIC 

VOLUME NAME 

COMMAND? 



P 
<. S*PROGB> P 



<volume name> 



where: 



<volume name> is the number of the drive 
on which your disk is installed 

<• S*PROGB> is the name of the system program file. 



Note the program file namei enter Q for the command 
prompt/ and press RETURN. 
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The installation process takes approximately twenty 
minutes t^ execute for a disk or one-half hour for a 
diskette. 

During this time^ you can check the status of the batch 
stream for completion and proper execution by issuing the 
SCI command Show Background Status (SBS) or Wait (WAIT). 
When the execution has completed^ the following message 
appears: 

COBOC INSTALLATION COMPLETE: ERRORS = nn 

If nn is not equal to zero» examine the batch listing to 
determine the error. The following error codes are normal and 
should be ignored. 

» 0001 — Error in a Release LUNO (RL) command 

» 0026 — Error in a Create File Directory (CFDIR) command 

* 0027 — Error in a Delete File (DF> command 

* 285F — Error in a Delete Task (DT> command 

* 295F — Error in a Delete Procedure (DP) command 

* 3158 — Error in a Delete Task (DT) command 



3. 3 COBOL Components 

During installation of COBOLf the components of the compiler and 
run-time support package^ shown in Table 3-l# are installed on 
the target disk. The target disk should be the DXIO system disk. 

DSC is a synonym set by the installation proc to the target disk 
name given by you. 
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Table 3-1 Compiler and Run-Time Support Package Files 



Directoru 

DSC. S*PROC 
XCP 
XCPF 

XCT 
XCTF 

XCTD 

XCC 

XCCF 



Directoru 

DSC. S*MSGX 

COBOL 

COBOLCMP 

M*41 

DSC. S*SYSLIB 

RCBPRC 

RCBNOIO 

RCBTSK 

RCBTSKD 

RCBMPD 

Tasks 

Program file 
DSC. S»SDS$ 
COBOL 

XCP 
XCPD 



Description 



SCI 


procedure -< 


SCI 


procedure — 


in Foreground 


SCI 


procedure — 


SCI 


procedure — 


in Foreground 


SCI 


procedure — 


SCI 


procedure — 


SCI 


procedure — 


in Foreground 



Execute COBOL Program 
Execute COBOL Program 

Execute COBOL Task 
Execute COBOL Task 

Execute COBOL Task 
Execute COBOL Compiler 
Execute COBOL Compiler 



Description 



Run-time message file 
Compiler message file 
Alias of COBOL 

Linkable run-time reentrant procedure 

module 
Linkable run-time reentrant procedure 

module uiithout I/O capabilities 
Linkable run— time task segment uiithout 

debugger 
Linkable run-time task segment with 

debugger 
Linkable run-time main program 

designator 

Description 



Compiler task uiith overlays COl 

C03» and C04 
Run-time task without debugger 
Run-time task with debugger 



C02, 



3-4 
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Table 3-1 Compiler and Run-Time Support Packa-ge Files (Continued) 



Procedures 

Program file 
DSC. S$SDS« 

RLOADER 

Program file 
DSC. S*PROGA 

RCOBOL 



Directory 

DSC. S*SYSLIB. C*SUBS 



Description 



Task loader 



Shared reentrant run-time 
procedure 

Description 

Run-time subroutine library 



If you uiish to delete the installed run-time package and compiler 
from your systemi use the Delete File <J>F)i Delete Directory 
(DD)/ Delete Task (DT)# or Delete Procedure (DP) commands/ as 
appropriate/ to remove the components listed in the preceding 
examples. 

Instructions for the verification of a successful installation 
are in Section 4. Instructions for building a COBOL execution 
diskette are outlined in Section 5. 



939431-9701 



3-5/3-6 



Object Installation Verifying the Installation 



Section 4 
Verifying the Installation 



A test program is provided on the DXIO COBOL disk to determine if 
the package is installed properly. Perform the following steps 
to verify the installation: 

1. Boot your system from the new system disk on which 
COBOL has been installed. 

2. Install the DXIO COBOL disk. 

3. Compile the test program by issuing the following 
command: 

C 3 XCCF S=CBLINS10. TESTCASE. 
0=*<volume name>. TESTOBJ* L=ME 

wh er e : 

<volume name> is the name of the disk on which the 
compiled object is to be placed. 

4. Execute the test program by issuing the following 
command: 

E 3 XCPF 0=<volume name>. TESTOBJ 

where: 

<volume name> is the name of the disk where the 
compiled object resides. 

If the test program completes satisfactorily* the 
following will be displayed on the video display 
terminal: 

THIS TEST PROGRAM RUNS ON A TI990 MINICOMPUTER 

IT IS WRITTEN IN TI COBOL 
HIT RETURN TO COMPLETE TEST 

Press the RETURN key to complete the test. 
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Once the program has executed satisfactorily/ delete 
the test program by issuing the following command: 

C D DF P=s<volume name>. TESTOBJ 

where: 

<volume name> is the name of the disk where the compiled 
object resides. 
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